============================================================
R E A D M E   -   D A T E I
------------------------------------------------------------
Datei:		Lightning.u
Objekt:		LightningTrigger
============================================================

Beschreibung:	Unreal Class Package
Autor:		Michael 'Sidewinder' Geisinger
Mail:		Sidewinder_GER@hotmail.com
Homepage:	http://sidewinder.de.vu/
Copyright:	Copyright (c) 2002 by Michael Geisinger
Version:	Version 1.1 (08Feb2002)
Build:		UnrealEd2 (436)
Getestet:	Unreal, Unreal - Return to Na Pali,
		  UnrealTournament, jedoch noch nicht
		  Netzwerk-getestet
Verhalten:	Erzeugt Blitze und Donner in zufllig
		  gewhlten Zeitabschnitten

============================================================
Diese Datei ist ein "Unreal Class Package". Es enthlt ein
Objekt, das in zufllig gewhlten Abstnden Blitze und
Donner erzeugt. Bitte lesen Sie sich den folgenden Abschnitt
genau durch. Dort werden die Funktionsweise und die Eigen-
schaften des Objekts genauer beschrieben. Um das Objekt
verwenden zu knnen, kopieren Sie Lightning.u in Ihr
Unreal\System-Verzeichnis und laden Sie es im UnrealEditor
mit dem Befehl "Load" der Seite "Classes" des Browsers.
Sie finden das Objekt unter Actors->Triggers.
------------------------------------------------------------

FUNKTIONSWEISE
	Das Objekt erzeugt in einem von Ihnen festlegbaren
	Bereich Blitze und Donner. Es sind allerdings noch
	andere Objekte erforderlich, damit das Objekt,
	"LightningTrigger", funktionieren kann. Der Donner
	wird direkt vom LightningTrigger durch Aufruf der
	Funktion <player>.ClientPlaySound aufgerufen.
	Dabei wird zufllig einer der in der Eigenschaft
	Thunders angegebenen Sounds gespielt. Jeder
	Spieler kann den Donner hren.
	Der Blitz ist etwas komplizierter: Das Objekt lst
	in zufllig gewhlten Zeitabstnden (mit MinTime
	und MaxTime festlegbar) eine Salve von Blitzen
	aus. Eine Salve enthlt zwischen einschlielich
	MinLightnings und MaxLightnings Blitzen. Um den
	Blitz darstellen zu knnen, mssen Sie ein oder
	mehrere TriggerLight-Actors in ihre Map einbauen.
	Diese Actors sind Lichter, die von einem
	Ereignis an- und ausgeschaltet werden knnen.
	LightningTrigger steuert die Lichter so, dass
	der Effekt eines Blitzes zustande kommt.
	Sie knnen so viele TriggerLight-Actors ver-
	wenden, wie Sie wollen. Sie knnen diese auch
	hinsetzen, wohin Sie wollen und ihnen beliebige
	Farbwerte geben.
	TriggerLight finden Sie unter den Klassen
	Object->Actor->Light. Sie mssen diesem Objekt
	nach dem Einfgen folgende Eigenschaften geben:
	Setzen Sie Object->InitialState auf TriggerToggle.
	Auerdem versehen Sie  die Eigenschaft Events->Tag
	mit einem beliebigen Text (z.B. "Lightning" oder
	"Blitz"). Sie mssen aber unbedingt darauf achten,
	dass Sie dem LightningTrigger in seiner Eigenschaft
	LightningEvent genau das selbe Ereignis angeben
	(sonst funktioniert der Blitz nicht)!
	WICHTIG: Das Objekt LightningTrigger muss erst
	aktiviert werden, damit es funktionieren kann.
	Geben Sie dem Objekt also ein Event->Tag, das
	von einem Trigger ausgelst wird. Erst dann werden
	Blitz und Donner einsetzen.
	Im Folgenden werden die einzelnen Eigenschaften
	des Objekts LightningTrigger genauer beschrieben.

------------------------------------------------------------

EIGENSCHAFTEN

	LightningEvent	Gibt das Ereignis an, das fr den
			Blitz ausgelst werden soll. Es
			muss mit dem Event->Tag der
			zugehrigen TriggerLights
			bereinstimmen.

	LightningTime	Gibt die Lnge eines Blitzes an.

	MaxFastTime	Gibt die maximale Lnge der Zeit
			zwischen den Blitzen einer Salve
			an.

	MaxLightnings	Gibt die maximale Anzahl der
			Blitze pro Salve an.

	MaxTime		Gibt die maximale Lnge zwischen
			den Blitz-Salven an.

	MinFastTime	Gibt die minimale Lnge der Zeit
			zwischen den Blitzen einer Salve
			an.

	MinLightnings	Gibt die minimale Anzahl der
			Blitze pro Salve an.

	MinTime		Gibt die minimale Lnge zwischen
			den Blitz-Salven an.

	MultipleThunder	Gibt an, ob whrend einer Salve
			mehrere Donner-Gerusche gespielt
			werden knnen (nicht empfohlen).

	Thunders	Gibt eine Liste der Donner-Sounds
			an. Fllen Sie die Liste unbedingt
			von oben nach unten auf!

------------------------------------------------------------

TIPS & TRICKS

	Duplizieren von TriggerLights
		Beim Duplizieren von TriggerLight-Actors
		mu man folgendes beachten: Die Eigenschaft
		Events->Tag des zu duplizierenden Objekts
		wird NICHT bernommen. Die Eigenschaft
		des neuen Objekts hat immer eine
		LEERE Zeichenkette!
		Sie muss BEI JEDEM neuen TriggerLight
		nochmals gesetzt werden.

	Mehrere LightningTriggers
		Besonders schn wird der Effekt, wenn man
		mehrere LightningTriggers in einer Map
		verwendet. So kann man z.B. einen Trigger
		fr die TriggerLights im "begehbaren" Teil
		des Levels verwenden und gleichzeitig einen
		anderen fr die SkyZone der Map. Man muss
		hierbei aber darauf achten, dass man den
		beiden Gruppen von TriggerLight-Actors und
		LightningTrigger-Actors unterschiedliche
		Werte fr Events->Tag bzw.
		LightningTrigger->Lightning gibt. Wenn man
		dann dem LightningTrigger, der fr die
		SkyZone zustndig ist, KEINE Thunder-Sounds
		gibt, tritt folgender Effekt auf: Wenn man
		in die SkyZone schaut, sieht man weit ent-
		fernte Blitze, deren Donner man nicht hren
		kann, doch zwischendurch schlgt auch mal
		ein Blitz ganz in der Nhe ein, der ein
		lautes Donnergerusch nach sich zieht.

	Donner-Sounds
		Gute Donner-Sounds fr die Eigenschaft
		Thunders bekommen Sie, indem Sie das
		Package "AmbOutside.uax" im SoundFX-
		Browser ffnen. Whlen Sie dann die
		Untergruppe OneShot. Thunder-Sounds
		haben den Namen "lightn...".

------------------------------------------------------------

IN PLANUNG

	In Planung ist eine Verzgerung zwischen Blitz und
	Donner,	um den Effekt noch realistischer zu
	gestalten.

------------------------------------------------------------

VIEL SPASS beim Verwenden von LightningTrigger wnscht
	Michael Geisinger

Copyright (c) 2002 by Michael Geisinger

- THE END -